Error Codes

back to section start!

 
ARexx Error Codes 
 
Lister handles are the actual address in memory of the lister structure. 
Opus 5 will reject any non-valid handles with an  RC  of 10. 
 
All commands that return data return it in  RESULT  (with the exception of 
 dopus getstring ,  dopus getdesktop  and  lister getstring ) or a specified 
(stem) variable; if an error occurs, the error code is returned in  RC . 
 
An  RC  of 0 generally indicates that everything is ok. 
 
Error codes are:- 
 
1       RXERR_FILE_REJECTED  
        The file you tried to add was rejected by the current lister 
        filters. 
        Note that this is not an error, just a warning. The file is still 
        added, it will just not be visible until the filters are changed.  
 
5       RXERR_INVALID_QUERY  
         RXERR_INVALID_SET  
        The query/set item you specified was invalid. 
 
6       RXERR_INVALID_NAME   
         RXERR_INVALID_KEYWORD  
        The filename or keyword you specified was invalid. 
 
8       RXERR_INVALID_TRAP  
        The trap you tried to remove didn't exist. 
 
10      RXERR_INVALID_HANDLE  
        The lister handle you gave was invalid. 
 
12      RXERR_NO_TOOLBAR  
        The lister has no valid toolbar. 
 
15      RXERR_NO_MEMORY  
        There wasn't enough memory to do what you wanted. 
 
20      RXERR_NO_LISTER  
        A lister failed to open (usually because of low-memory). 
 
You can convert the error codes returned in  RC  into meaningful error 
messages (for error reports and so on) with the  dopus error  command. 
 

DOpus PLUS - giving you that bit extra...